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left of the affected text. 

In addition, the following changes should be made to the publication: 
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Amendment 

Change the Meaning of the mnemonic "HEADR" (under "Assembly 
Control Codes") to read 

Header Line 

Under the heading "Assignment of Data Areas in COMMON", the 
first paragraph refers to "Figures 61 and 62". Change this refer- 
ence to read: 

Figures 35 and 36 

In the section "Use of Labels Referencing COMMON," there are two 
references to "Figure 61". Change these references to read: 

Figure 35 

The first complete sentence on the page ends with "skip to state- 
ment 004". Change this to read: 



skip to the statment labeled L . 

51 The second sentence in Note 2 ends with the word "common". The 

word "common" should be capitalized to read: 

COMMON 

Please file this cover letter at the back of the publication. It provides a method of de- 
termining that all changes have been received and incorporated into the publication. 
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1. SEQNO — Sequence Number: The sequence 
( number of statements as they appear in the assembly 

listing. 

2. PGLIN — Page and Line Number: The page and 
line number as it appears in columns 1 through 5 of 
the cards in the source deck. Page and line numbers 
must consist of five non-blank characters and must ap- 
pear in ascending sequence. 

Statements generated by the macro generator will 
have a page and line number in this field supplied by 
the generator. These numbers have no relationship to 
the numbers of the hand-coded statements; they rep- 
resent the order in which the statements appear in the 
Macro Library. 

The space between the seqno and pglin columns of 
the listing are used by the processor to contain either 
an "S" or a "G," under the following conditions. 

S — The page and line number of the statement is 
not in ascending sequence in. relation to the preceding 
source statement. This is only a warning to the pro- 
grammer that his source statements may be out of 
sequence. 

G — This character differentiates statements pro- 
duced by the macro generator from the hand-coded 
source statements. 

3. LABEL — Label: The contents of the label field, 
columns 6 through 15, of the Autocoder statement. 

4. OPCOD: The Operation Code, columns 16 
through 20, of the Autocoder statement. 

5. OPERAND: The contents of the operand field, 
columns 21 through 72, of the Autocoder statement. 

6. REL — Relocation Indicator: This is a code char- 
acter that indicates to the Linkage Loader the type 
of relocation to be applied to the element(s) in the 
statement. 

7. CT — Character Count: The length in characters 
of the assembled imperative statement, or the number 
of core-storage locations reserved for a constant de- 
fined in a declarative statement. 

8. ADDRS: The relative address assigned by the 
processor to the instruction or constant. This address 
is subject to relocation. 

9. INSTRUCTION: The assembled machine-lan- 
guage instruction or constants from which the object 
deck is constructed. 

10. CARD — Card Number: The sequence number 
of the card in which the associated constants or in- 
structions appear in the object deck. This sequence 
number is automatically computed and placed in col- 
umns 73-75 of each card in the object deck, in ascend- 
ing order. 



11. FLAG: An alphabetic character indicating an 
actual or possible programming error. As many as five 
flags can be assigned to one Autocoder statement. The 
flags provided are as follows: 

F — invalid statement Format 

M — Multiple definition of a label 

N — macro generation Note 

O — invalid Operation code 

R — Restricted operation code ( if not generated 
by a macro ) 

U — Unidentified label in the operand 

W — Warning, general classification of error 

Details concerning the above flags can be found in 
Appendix A. The total number of flagged statements 
is indicated at the end of the assembly listing, followed 
by a line which contains the sequence number of each 
flagged statement, to a maximum of 20 numbers. The 
presence of any flag except "R" causes the processor 
to set the "no-go" switch during assembly. This setting 
of the "no-go" switch can cause a bypassing of all the 
source cards up to the next job. See the System Monitor 
publication. 

The assembly listing can be supplemented by a cross 
reference listing at the option of the user, by means 
of the pst statement. This listing analyzes the sub- 
program^) just assembled, and lists each label, fol- 
lowed by the sequence number of the statement in 
which it was defined, and the sequence number of 
each statement in which the label is used as a reference 
address. See "pst — Print Symbol Table," in the sub- 
section "Control Operation Codes," for a more detailed 
explanation. 

Note: The system symbol /lin/ controls the line 
count on the listing page. However, if this system sym- 
bol calls for the printing of less than 30 lines per page 
the processor will reject this direction and print the 
assembly listing at the normal 55 lines per page. See 
the System Monitor publication for details concerning 
this system symbol. 



Replacement Codes 

The Autocoder processor utilizes a second line (nor- 
mally blank) in the assembly listing, for the representa- 
tion of non-printable characters. Each of these char- 
acters is represented by two characters, one printed 
above the other, at the appropriate place in the listing. 
These two-character substitutions are called replace- 
ment codes, and they appear most frequently as re- 
location indicators or operation modifiers. 
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The two-character replacement codes with their con- 
ventional graphic representations, card codes, and 
names are listed in Figure 3. 



Replacement' 
Code 


Graphic 


Card 
Code 


Name 


i 


? 


12-0 


Plus Zero 


6 


| 


11-0 


Minus Zero 


G 

M 


i 


12-7-8 


Group Mark 


Q 
T 


+++ 


0-7-8 


Segment Mark 


W 
S 


ry-i 


0-5-8 


Word Separator 


D 
L 


A 


11-7-8 


Delta 


C 

T 


<J or ,6 


2-8 


Cent Sign or Substitute Blank 


L 
P 


[ 


12-5-8 


Left Bracket 


R 
P 


] 


11-5-8 


Right Bracket 


T 
M 


sT- 


7-8 


Tape Mark 


L 
T 


< 


12-6-8 


Less Than 


G 
T 


> 


6-8 


Greater Than 


/ 


r 


U-6-8 


Semicolon 






5-8 


Colon 


II 

b 


\ 


0-6-8 


Backslash 



Figure 3. Replacement Codes 



Coding Sheet 

The Autocoder Coding Sheet (Figure 4) provides a 
convenient form for coding source program statements. 
Column numbers on the coding sheet have a one-for- 
one correspondence to the columns on the card used to 
punch the source statements (Autocoder Input Card, 
FormA36199). 

Each line of the coding sheet is punched into a sepa- 
rate card. The source deck, therefore, consists of a 
sequenced set of punched cards containing a line-by- 
line representation of the coding sheets. 

The following paragraphs explain the function of 
each field. The heading information, Program, Pro- 
grammed By, and Date, are only for documentation, 
and are not punched. 



Identification (Card Columns 76-80) 

This five-position field can contain a name created by 
the programmer to identify the program. This identi- 
fication will be punched into 76-80 of the object deck 
only if it appears in a headr or eeseq control card. ( See 
"Control Operation Codes.") However, the identifica- 
tion is not checked on the other Autocoder statements, 
and serves only to identify the program to which the 
card belongs. Special, as well as alphameric, characters 
are permitted. 

Page Number and Line Number (Card Columns 1-5) 
The page number (columns 1 and 2), in conjunction 
with the line number (columns 3-5), provides a means 
of sequencing the cards in the source deck. This enables 
the programmer to identify and correlate the entries 
on the coding sheet and assembly listing with the 
entries in the source xleck. Alphabetic, as well as nu- 
meric, characters can be used. ( If the standard collat- 
ing sequence is not followed, the processor will place 
a sequence (S) flag next to the pglin field in the as- 
sembly listing, as previously explained. ) 

Label (Card Columns 6-1 5) 

This field, if used, contains the label being defined in 
this statement. 

Operation Code (Card Columns 16-20) 

This field contains the operation code. 

Operand (Card Columns 21-72) 

This field, if used, contains the operand element(s) of 
the statement. 
Note: Columns 73-75 should be left blank. 

COMMENTS 

Comments are remarks or notes written by the pro- 
grammer in the operand field. At least two blank spaces 
must separate a comment from the last character of 
the statement. The comment, punched in the source 
deck, appears in the assembly listing but is not con- 
tained in the object deck, and has no effect on the 
object program. 

COMMENTS CABD 

It may, at times, be helpful to insert an entire line of 
descriptive information. This is done by placing an 
asterisk in column 6 and using the balance of the line 
(up to column 72) for comments. When this line of 
information is punched into a card of the source deck, 
the asterisk will identify it to the processor as a com- 
ments card. The comments will be printed in a single 
line of the assembly listing at the point of encounter, 
which can be anywhere in the source deck, except as 



12 



Form C28-0326-2 
Page Revised 6/24/65 
By TNL N27-1223 



IBM 

Program 

Programmed by- 
Date 



Form X24-1 350-1 
Printed in U.S.A. 



INTERNATIONAL BUSINESS MACHINES CORPORATION 

IBM 1401 AND 1410 DATA PROCESSING SYSTEMS 

AUTOCODER CODING SHEET 



Identification ■ ■ ■ 

76 

Page No.l_t_l of . 
I 2 



Line 

9 S 


Label 

6 15 


Operation 
16 20 


OPERAND 

21 25 30 35 40 45 50 55 60 65 70 


0,1. 








0,2 












































































































0,3 












































































































0,4, 














































































































0,5, 














































































































0.6, 
















































































































0,7. 
















































































































0,8, 
















































































































0,9, 
















































































































1,0, 
















































































































1,1, 
















































































































1.2, 
















































































































1,3, 
















































































































1,4, 
















































































































'i*i 
















































































































1,6, 
















































































































1.7. 
















































































































P. 8, 
















































































































1.8, 
















































































































2,0, 
















































































































2,1, 
















































































































2,2. 
















































































































2.3, 
















































































































2.4, 
















































































































2,5, 























































































































































































































































































































































































































































































































































































































































































Figure 4. The Coding Sheet Form 



noted under "Implied dcw Operation Codes." Com- 
ments cards have no effect on the object program and 
are not included in the object deck. However, a com- 
ments card inserted in a series of chained Autocoder 
operation codes will break the chain. It is, therefore, 



necessary to restate the operation code and to provide 
the proper operand on the first source card statement 
following the comments card, in order to resume a 
chained action. In summary, a chain which is broken 
by a comment must be made into two chains. 
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Types of Operand Entries 



This section explains the form and use of the various 
entries permitted in the operand field of imperative, 
declarative, Linkage Loader, and control statements. 
The operand field of an Autocoder statement is used 
to specify a variety of information to the processor. 
The function of a specific entry is dependent upon the 
type of Autocoder statement in which it appears. The 
normal operand usage with each of the five types of 
Autocoder statements is as follows. 



STATEMENT TYPE 

IMPERATIVE 



DECLARATIVE 



LINKAGE LOADER 



CONTROL 



MACRO 



OPERAND CONTENTS 

Symbolic address(es) to be operated 
upon by the machine instruction, and 
a d-modifier, when required 
Constants, symbols, and/or control 
parameters necessary to declare the 
desired fields 

Symbolic (or actual) addresses and/or 
control parameters required to convert 
the object deck into absolute format 
Symbolic (or actual) addresses and 
constant information indicated by the 
operation code 

Parameters of the macro statement 
(These parameters are discussed in 
the section entitled, "The Macro Sys- 
tem." ) 

All permissible operand entries are explained and 
illustrated under the following headings: 
Basic Addresses 
Address Adjustment 
Indexing 
Literals 

Linkage Symbols 
System Symbols 
Miscellaneous 



Basic Addresses 

Basic addresses contained in the operand field of an 
Autocoder statement are the primary elements of 
information conveyed to the processor. They can be 
altered or modified by means of additional elements 
contained in the operand field. 

A basic address is the symbolic or actual representa- 
tion of a core-storage location of the data, field or in- 
struction referred to by the Autocoder statement. 
A basic address can be in one of three forms: 

Symbolic 

Asterisk 

Actual 



Symbolic 

A symbolic address is an operand entry that appears 
elsewhere in the source program as a label. As a rule, 
this symbol can be defined as a label either before or 
after the Autocoder statement in which it appears as 
an address. The exceptions to this rule are as follows: 

1. All symbolic operands appearing in org, ltorg, 
and equ statements must have been previously defined 
within the same program. 

2. The symbolic address appearing in an rsv state- 
ment must precede any other use of this symbol in a 
program. ( See "rsv — Reserve.") 

3. The symbolic representations of index registers 
(XO, X1-X15) and the common data area (common), 
must never appear in the label field. They cannot be 
defined by the user because they are predefined labels 
in the symbol table maintained by the Autocoder proc- 
essor. 

The instruction in Figure 5 illustrates the use of 
symbolic addresses. The symbols total and accumu- 
late are defined as labels elsewhere in the program. 
The assembled instruction will cause the contents of 
the core-storage area labeled total to be moved to the 
area labeled accumulate. 

Note: A symbolic address will receive upward, 
downward, or no relocation, depending on the manner 
in which the symbol is defined. 



Line 

3 5 


Label 

6 15 


Operation 
16 20 


21 25 30 35 40 j 


1, 


G.A.O.S.S. i . , , 


ML.CA. 


T.OT.A.L.,.A.C.C.UMU.L.A.T.E. . . . .) 


2 


I 




i i 1 I 1 . j 1 1 1 1 1 1 1 1 — t — 1 1 1 1 1 J 



Figure 5. Autocoder Instruction with Symbolic Addresses 



Asterisk (*) 

An asterisk ( 11-4-8 punch ) can be used as a basic ad- 
dress in an Autocoder statement. When compiling the 
object program, the processor will replace the asterisk 
with the relative core-storage address of the last char- 
acter of the instruction or data field created by the 
statement in which it appears. However, if an asterisk 
address is used in a statement that does not cause the 
generation of an instruction or data area in the object 
program, the value substituted for the asterisk will be 
the current location in the object program. 



14 



Blank Constants 

A field of blanks can be reserved by placing a # char- 
acter (3-8 punch) in column 21, followed by a number 
indicating how many consecutive blank core-storage 
positions are to be defined (Figure 40). A word mark 
is set in the high-order position of this field. 

Note: The number of successive blank constants 
that can be reserved by a dcw statement is limited to 
500 positions of core storage. If this limit is exceeded, 
the processor will reserve only the maximum (500 
positions), and attach an "F" flag to the statement on 
the assembly listing. 
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a storage location. In Figure 42, manno ( actual address 
00500) has been address adjusted by +12. Thus, the 
location labeled fica will contain the address constant 
00512. 



Line 

3 5 


Label 

6 IS 


Operation 

16 20 


21 25 30 35 40 < 


0,1, 


FI.C.A ■ ! ■ ■ ■ 


DCW , 


MAM/J.0.4-.1.2 { 


0,2 


i , , , 







Figure 42. Address Constant with Address Adjustment Defined 
in dcw Statement 
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Figure 40. Field of 14 Blanks Defined in a dcw Statement 

Address Constants 

A dcw statement can be used to define an address 
constant. The constant is the address of the field whose 
label is written in the operand. For example (Figure 
41), assume that the label manno is used in the sym- 
bolic program, and that it was assigned the address 
00500 by the processor. The programmer can refer to 
the address of manno by using the symbolic label of 
the dcw statement. 



Line 

3 5 


Label 

6 15 


Operation 

16 20 


21 25 30 35 40 < 


0, 1 , 


S,£,fil.A.L\ . 


DCW. 


VLA.NM6 i 


O 2 


■ i 

- s ■ ■ ■ 







Figure 41. Address Constant 



The five-character data field labeled serial ( Figure 
41) will contain the address of the label manno 
(00500). The Linkage Loader will recognize address 
constants and adjust them by the proper relocation 
factor. Thus, serial will contain the relocated address 
of manno. 

If an address constant is address adjusted in a dcw 
statement, the constant is adjusted before it is assigned 



Address constants defined in a dcw statement can 
be indexed. The zone bit(s) indicating the specified 
index register becomes part of the constant. 

Note 1: All address constants receive the same relo- 
cation indicators that were assigned to the symbol 
specified in the operand field. 

Note 2: An address constant of a linkage or system 
symbol can be specified, and the desired address will 
be automatically supplied by the Linkage Loader. 
However, this form of address constant cannot be 
address adjusted or indexed. 



Signed Address Constants 

An address constant defined in a dcw statement can be 
signed. A and B bits will be generated by the processor 
over the units position, if the plus ( + ) sign was placed 
before the operand. The units position will contain a 
B bit if the minus ( — ) sign was used (Figure 43). 
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6 15 


Operation 
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S.£.K.I.A.L\1. , 


dcw. . 
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DCW. . 


-.HtI.TMO.LB.TMe 1 



Figure 43. Signed Address Constants Defined in dcw Statement 

Implied DCW Operation Codes 

If several constants are to be defined in succession, only 
the first statement (or any statement preceded by a 
comments card) requires the mnemonic dcw in the 
operation field ( Figure 44 ) . 
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6 15 


Operation 
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Figure 44. Successive dcw Statements with Blank Operation Columns 
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DC — Define Constant (no word mark) 

The function performed by the dc statement, and the 
permissible forms of the constants, are identical to 
those described for the dcw statement. The only differ- 
ence is that the word mark is absent when the constant 
is assigned to core storage ( Figure 45 ) . 
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G>.r?.R.l.GSS,T.& { 
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ssniMbfji. 




»my-.in.-is.oog>, \ 


0,4 




. . t 





Figure 45. Successive dc Statements with Blank Operation 
Columns 



Note: The restriction on the use of an initial word 
separator character in the dcw statement defining an 
alphameric constant does not apply to the dc statement. 



DS — Define Symbol 

The ds statement is used to label and define an area 
within the subprogram. No information is entered into 
the area, no word mark is assigned by the processor, 
and the area is not cleared prior to reservation. The 
programmer specifies the size of the area, and desig- 
nates the symbolic label by which it will be referenced. 
The number of desired consecutive positions of core 
storage is written in the operand field ( Figure 46 ) . The 
label refers to the low-order position of the area. 
However, if the label is indented one place, that is, 
if it begins in column 7, the label will refer to the high- 
order position. A label is not mandatory. 



Line 

3 5 


Label 

6 15 
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21 25 30 35 40 \ 
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resentation of the location to be "equated" is specified 
in the operand field. 

An equ statement can be used to assign a symbolic 
label to each of the following: 

Actual or symbolic address 

Adjusted or modified address 

Index register 

Asterisk address 

Actual or Symbolic Address 

The symbol to be defined is specified in the label field. 
The operand field can contain an actual or symbolic 
address. If a symbolic address is specified in the op- 
erand field, it must have appeared as a label prior to 
this point in the subprogram. If this condition is not 
met, the label will not be defined. 

SYMBOLIC ADDRESS 

The equ statement in Figure 47 will cause the processor 
to assign the same address to the label individual 
that is assigned to the symbol manno. Thus, individual 
has been equated to manno — both labels refer to the 
same core-storage location and are assigned the same 
relocation indicator by the processor. 
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Figure 46. Defining Twelve-Position and Five-Position Areas in 
ds Statements 



Figure 47. Equating a Symbolic Address 



ACTUAL ADDRESS 

The equ statement in Figure 48 will cause the processor 
to assign the label acctno to machine location 25000. 

Note: Labels equated to actual addresses will be 
treated as absolute values and given a no relocation 
indicator. 



Figure 46 illustrates the form of the ds statement. 
The first entry, labeled dozen, defines an area twelve 
positions long. The second entry, labeled five, defines 
an area five positions in length. 
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Figure 48. Equating an Actual Address 



EQU — Equate 

The equ statement is used to define either a second 
symbol to reference a specific location, or a symbol 
for a location not previously labeled. The symbol to 
be defined is specified in the label field, and the rep- 



Adjusted or Modified Address 

The operand of an equ statement can be address ad- 
justed or indexed. The same relocation indicators 
assigned to the address adjusted and/or indexed op- 
erand will be given to the defined label. 
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Figure 78. ibm 1410/7010 Library Coding Form 
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Figure 80. Model Statement for a Complete Instruction 
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Figure 79. Macro Operations 



that a corresponding parameter from the macro- 
instruction operand field must be inserted in its 
place. This code is a n followed by a number 
from 001 to 199, that indicates the position of 
the parameter in the macro-instruction. The 
macro-instruction in the source program will 
give the parameter entries to be inserted in the 
object routine. The model statement is illus- 
trated in Figure 81. 
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Figure 81. Model Statement for an Incomplete Instruction with 
Required Parameters 

c. If the entry is incomplete, the programmer 
writes a □ followed by a number from 001 to 199 
with ab bits over the units position (parameter 
001 is nOOA, parameter 2 is nOOB, etc.). This 
indicates that the entry is to be included in the 
object routine only if the parameter is specified 
by the macro-instruction. For example, if pa- 
rameter 003 does not appear in the macro- 
instruction, the instruction shown in Figure 82 
will be deleted from the object routine. 
Note: If parentheses are used, the programmer can- 
not use zoned switches in a math or bool statement. 
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Figure 82. Model Statement for an Incomplete Instruction with 
Conditional Parameters 

Labeling: If the model statement represents an in- 
struction entry point for a branch instruction elsewhere 
in the program, it should have a label. 

If additional external labels are required and speci- 
fied as parameters in the macro-instruction they can 
be inserted in the label field of the symbolic program 
entry by using the dOOl-199 code. 

The label of the macro-instruction causes the genera- 
tion of an equate statement in the assembled object 
routine. The label is equated to an *, as shown in 
Figure 83. 



Another example is shown in Figure 84. 

Symbolic Addressing within the Library Routine: 
To allow a symbolic reference to other instructions in a 
library routine a □ followed by a number from 001 to 
199 with a B bit over the units position (nOOJ = sym- 
bolic address 1, nOOK = symbolic address 2, etc. ) can 
be used. For example, the processor generates the sym- 
bolic address if the code nOOJ is used as a label for one 
entry and as an operand of at least one other entry in 
the same library routine. 

Internal labels within flexible routines are generated 
in the form nnnnmmm, where nnn is the code (00J- 
09R), and mmm is the number of the macro within 
the source program. This is done to avoid duplicate 
address assignments for labels. 

Example: Use the generated symbolic address of 
□00J as an operand for entry 3 and as the label for 
entry 6. updat is the 23d macro encountered in the 
source program ( Figure 85 ) . 

Address Adjustment and Indexing: The parameters 
in a macro-instruction and the operands in partially 
complete instructions in a library routine can have 
address adjustment and indexing. 

If address adjustment is used in both the parameter 
and the instruction, the assembled instruction will be 
adjusted to the algebraic sum of the two. For example, 
if the address adjustment on one is +7 and the other 
is —4, the assembled instruction will have address 
adjustment equal to +3. 

Model statement operands can be indexed. This in- 
dexing takes precedence over any indexing of a param- 
eter supplied by a macro-instruction. The model state- 
ment index is used. 

Literals: Operands of instructions in library routines 
may use literals as required. However, these literals 
may not contain the @ symbol within an alphameric 
literal. 
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Figure 84. Additional External Labels 



